home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / FILER / CLICBACK.ZIP / ClicBack / !ClicBack² / !Retrieve / !Help < prev    next >
Text File  |  1995-09-25  |  11KB  |  257 lines
  1. Please note that this application is NOT Public Domain, it is 
  2.  
  3.  
  4.           CCCCC   AAAA   RRRRR   EEEEEE  WW   WW  AAAA   RRRRR   EEEEEE
  5.         CC       AA  AA  RR  RR  EE      WW   WW AA  AA  RR  RR  EE
  6.         CC       AA  AA  RR  RR  EE      WW W WW AA  AA  RR  RR  EE
  7.         CC       AAAAAA  RRRRR   EEEEE   WW W WW AAAAAA  RRRRR   EEEEE
  8.         CC       AA  AA  RR RR   EE      WWWWWWW AA  AA  RR RR   EE
  9.         CC       AA  AA  RR  RR  EE      WWW WWW AA  AA  RR  RR  EE
  10.           CCCCC  AA  AA  RR  RR  EEEEEE  WW   WW AA  AA  RR  RR  EEEEEE
  11.  
  12. It is NOT free software.
  13.  
  14. You may pass on copies of this Demonstration Copy to your friends 
  15. providing that it is distributed complete with this documentation file, 
  16. and with the copyright message intact.
  17.  
  18.                                !ClicBack
  19.                        Hard Disk Backup Utilities
  20.                              Version 2.8
  21.                             © Steve Spry 1995.
  22.  
  23. !ClicBack Utilities are CAREWARE and NOT PUBLIC DOMAIN. 
  24. This means that the proceeds are given to charity.In the case of these 
  25. programs the charity is CLIC,The Cancer & Leukaemia In Childhood 
  26. Trust, registered charity number 802396.
  27. If, after a period of two weeks, you find the program useful you are 
  28. required to register your copy of the programs for a fee of £10.  This 
  29. payment will entitle you to the "Key" file which will remove the banner 
  30. file and put your name into the Info box. As a registered user you will
  31. also be entitled to free technical support.
  32. To register your copy of the programs please send a cheque or postal 
  33. orders made payable to Steve Spry and a blank formatted disk to:
  34.  
  35.                   Steve Spry
  36.                   36 Moreton Avenue
  37.                   Bideford
  38.                   North Devon
  39.                   EX39 3AY
  40.  
  41. If you could also inform me as to which version of RISCOS you 
  42. have, the amount of memory you have, the processor and the size of 
  43. your hard disk it would help me to develop the program further.
  44.  
  45.  
  46. Background
  47. ~~~~~~~~~~
  48. This program had been sitting on my hard disk for nearly three years 
  49. in a half finished state whilst I played around with data compression 
  50. techniques. 
  51. Following the death of my five year old son from a brain tumour in 
  52. January 1993 I decided to finish this program and donate the proceeds 
  53. to CLIC.  As the program progressed more and more features were 
  54. added or changed. Even now there are things that I would like to 
  55. change but I could carry on for ever.
  56.  
  57. This program is dedicated to his memory and all those brave young 
  58. children fighting all forms of cancer.For there sake, if you like the 
  59. program, please register your copy of the program.
  60.  
  61. Further details about CLIC can be obtained from:
  62.  
  63.                   12-13 King Square,
  64.                   Bristol,
  65.                   BS2 8JH
  66.                   Tel: 0117 9248844
  67.                   Fax: 0117 9244505  
  68.  
  69.  
  70. Introduction
  71. ~~~~~~~~~~~~
  72. The main features of the programs include :
  73. • Full, Differential and Incremental backups.
  74. • Selective option to preserve history integrity
  75. • Backup to floppies or another hard disk.
  76. • Backup only specified directories or files.
  77. • Exclude any files or directories from the backup.
  78. • Verify whilst backing up.
  79. • Password protection for added security.
  80. • 32 bit CRC
  81. • Restore data to any directory.
  82. • Powerful searching facility to locate Files / Directories or
  83.   Applications within backup data.
  84. • Ability to restore whole directories or applications.
  85. • Variable data compression.
  86. • Estimate number of floppy disks required.
  87. • Estimate time required to complete backup.
  88. • Time taken so far.
  89. • Save settings as configuration files.
  90. • Customisation file.
  91. • Acorn’s Interactive help supported.
  92.  
  93.  
  94.  
  95.                              Retrieve
  96.                              ~~~~~~~~
  97. Retrieve is copied to the last disc in the backup sequence along with a
  98. file which holds the information that !Retrieve needs in order to
  99. locate and restore the selected object.
  100.  
  101. This program is used to restore single files, directories or 
  102. applications.  The program is loaded by double clicking on 
  103. the !Retrieve icon.  Clicking on the iconbar will open the programs 
  104. main window. 
  105.  
  106. Figure 7
  107.  
  108. Main Window
  109. ~~~~~~~~~~~
  110. The main window has a writable icon for you to specify the name of 
  111. the file/directory or application which you wish to restore.  There is a 
  112. group of three icons which enables you to select what type of object 
  113. you are looking for. The ‘Wildcard’ icon will extend the window to 
  114. show the available wildcards.
  115.  
  116. The wildcards are as follows:
  117. Digit #     - Matches any characters 0-9
  118. Any .       - Matches any single character
  119. Not ~       - Matches any character except the character specified.
  120. Alphanum @  - Matches any alphanumeric character a-z, A-Z, 0-9 or _.
  121. Set []      - [abc] matches any of the characters a, b, or c.  
  122.               Note that a set is always case sensitive.
  123. Normal \    - \s will match the character s even if s is 
  124.               a special character.
  125. 0 or more * - *c matches 0 or more occurrences of c, where c is any of 
  126.               the simple character patterns listed above.
  127. 1 or more ^ - ^c matches 1 or more occurrences of c, where c is any of 
  128.               the simple character patterns listed above.
  129.  
  130. Clicking on Run or pressing return will start the search.  If the search 
  131. finds more than fifty objects that matches the search pattern then an 
  132. error will be generated prompting you to narrow the search pattern to 
  133. reduce the number of possible matches and only the first 50 matches 
  134. will be displayed.
  135. The matches will be displayed in a separate window called the 
  136. search window as shown below.  This shows the result of searching for 
  137. objects called unique with the files and applications options set.  To 
  138. restore a selected file simply drag it from this window to the directory 
  139. you wish to restore the file to.  The program will prompt you to insert 
  140. the required disks and proceed as for a normal restore.  Several objects 
  141. can be selected from the Matches window by clicking select on the first 
  142. object and using Adjust to select subsequent objects. 
  143.  
  144. Figure 8
  145. History
  146.  
  147. 1.00
  148. Not so much of a hard disk backup program but a hard disk cleaner. 
  149. Managed to wipe every other file on a hard disk. If it wasn’t for a bug I 
  150. would have had the lot. sorry Buck!
  151.  
  152. 2.01
  153. A working Multi-tasking backup program which I was reluctant do 
  154. release into the world incase there where any bugs that I had not found 
  155. despite extensive testing.Finally plucked up the courage to release it 
  156. and was pleased by the stability of the program.
  157.  
  158. 2.06
  159. Fixed the minor bugs that have been reported and made some 
  160. improvements that have been suggested by users e.g. Pause, better 
  161. compression ratio etc.
  162.  
  163. 2.50
  164. Implemented the Difference Algorithm instead of using just  the date 
  165. time stamp.  Fixed a bug that prevented !ClicBack from formatting 
  166. high density disks (couldn’t test this on my old A3000).  Added the 
  167. compression level to the options file.  Sorted out !Restore to only close 
  168. the destination window.  Fully tested on the RiscPC.
  169.  
  170. 2.51
  171. Fixed a bug that missed the last character off the filename when 
  172. using !Retrieve.
  173.  
  174. 2.52
  175. Added detection of native RISCOS format disks. !ClicBack will now 
  176. only accept D/E or F formatted disks.
  177.  
  178. 2.53
  179. Fixed a bug that prevented !Retrieve restoring any single file that 
  180. was split across two or more disks.
  181.  
  182. 2.54
  183. Removed “Unstamped” option as it has been made redundant since 
  184. the release of version 2.50. Also fixed a bug that would cause 
  185. !ClicBack to crash if there were no files to backup.
  186.  
  187. 2.60
  188. Removed all restrictions on the demonstration version of the 
  189. programs and decided to use a key file for registered users. (Thank you 
  190. David Holden).  Included and Shift-Drag option for excluding files to 
  191. exclude all object with a given leafname.  Finally tracked down the
  192. problem with !Restore asking for a disk beyond the last disk in the
  193. backup set.
  194.  
  195. 2.70
  196. Following several phone calls from David Holden I have changed a number
  197. of things in this version and fixed a problem with ArcFS and SparkFS which
  198. would cause !ClicBack to crash when ArcFS or SparkFS ran out of memory.
  199. The problem was caused by the above two programs intercepting calls to
  200. OS_GBPB and OS_File and changing the object type returned from these calls
  201. from 3 (Image files) to 2 (directory).  !ClicBack therefore thought that
  202. it was recursing through a directory structure and wasn't expecting another
  203. program to deny access to a file because it was out of memory.  Anyway it's
  204. fixed now.  Also changed the following:
  205.   1.  User interface - I think this gives a cleaner, less cluttered feel
  206.       to the program.  I know the popup menus do not appear in quite the
  207.       right positions but I cannot find a way around in in Risc_OSLib.
  208.   2.  Changed format of configuration files.  These are now in a human-readable
  209.       format, the syntax of which can be found elsewhere in this manual.
  210.   3.  Added a means for the user to specify which files not to compress.  This
  211.       can make backing up data a lot quicker as the program no longer has to
  212.       work so hard in order to same a few k's compressing pre-compressed files.
  213.   4.  Re-coded a large portion of the programs, saving quite a bit of space
  214.       and, hopefully making it a bit quicker.
  215.   5.  !ClicBack now recognises image files and will back them up as a
  216.       single (sometimes large) file (DOS partition files).
  217.   6.  Cleared the bug that would cause the program to sometimes crash when
  218.       you selected History.  I still don't know why it did it but i've
  219.       recoded this and the problem (appears) to have vanished.  The
  220.       text justification of the history file does appear a bit strange on
  221.       a RiscPC if you are using an outline font for the desktop.
  222. 2.71
  223. Fixed a problem with the lists that would cause the program to crash if
  224. the user selected all items and then selected remove.
  225. Also changed the saving of options files to save the numerical filetype
  226. and not the string filetype as this could cause problems if the textual
  227. filetype was not know to the system when the options file was loaded.
  228.  
  229. Future Plans
  230. I intend to make the restore program more visually based. i.e. show a 
  231. directory tree and allow you to point and click to specify the files to 
  232. restore.  As usual the problem is time.
  233.  
  234. Improve the search facilities to incorporate fuzzy matching. i.e. a 
  235. search for directtory would find directory.
  236.  
  237. And the normal improvement ..... speed. I hope to double the 
  238. program speed of the backup eventually. The speed of restoration is 
  239. already pretty impressive for large files.
  240.  
  241. known bugs
  242. None at the moment.... and as they say, it's not a bug it's just an undocumented
  243. feature!!!!
  244.  
  245. Thanks To
  246. Dominic Symes for THE text(?) editor !ZAP. If you haven’t got a 
  247. copy get one!
  248. Martin Ebourne and Bryan Scattergood for the C/Assembler modes in !ZAP.
  249. Acorn for there C Compiler (and computer).
  250. Jonathan Marten for the inspiration to start this program. (UAP ?)
  251. Chris Taylor for the suggestions on improving the program and encouragement
  252. My wife for being a computer widow.
  253. David Holden for persuading me to remove all restrictions on the program and
  254. for his advice and suggestions regarding !ClicBack's operation.
  255. And all registered users of the program. 
  256.  
  257.